NetError

The network error codes.

Entries

Link copied to clipboard

The error is unknown.

Link copied to clipboard

No error.

Link copied to clipboard

An asynchronous IO operation is not yet complete. This usually does not indicate a fatal error.

Link copied to clipboard

A generic failure occurred.

Link copied to clipboard

An operation was aborted due to user action.

Link copied to clipboard

An argument to the function is incorrect.

Link copied to clipboard

The handle or file descriptor is invalid.

Link copied to clipboard

The file or directory cannot be found.

Link copied to clipboard

An operation timed out.

Link copied to clipboard

The file is too large.

Link copied to clipboard

An unexpected error. This may be caused by a programming mistake or an invalid assumption.

Link copied to clipboard

Permission to access a resource, other than the network, was denied.

Link copied to clipboard

The operation failed because of unimplemented functionality.

Link copied to clipboard

There were not enough resources to complete the operation.

Link copied to clipboard

Memory allocation failed.

Link copied to clipboard

The file upload failed because the file's modification time was different from the expectation.

Link copied to clipboard

The socket is not connected.

Link copied to clipboard

The file already exists.

Link copied to clipboard

The path or file name is too long.

Link copied to clipboard

Not enough room left on the disk.

Link copied to clipboard

The file has a virus.

Link copied to clipboard

The client chose to block the request.

Link copied to clipboard

The network changed.

Link copied to clipboard

The request was blocked by the URL block list configured by the domain administrator.

Link copied to clipboard

The socket is already connected.

Link copied to clipboard

The upload failed because the upload stream needed to be re-read, due to a retry or a redirect, but the upload stream doesn't support that operation.

Link copied to clipboard

The request failed because the URLRequestContext is shutting down, or has been shut down.

Link copied to clipboard

The request failed because the response was delivered along with requirements which are not met (X-Frame-Options and Content-Security-Policy ancestor checks and Cross-Origin-Resource-Policy, for instance).

Link copied to clipboard

A connection was closed (corresponding to a TCP FIN).

Link copied to clipboard

A connection was reset (corresponding to a TCP RST).

Link copied to clipboard

A connection attempt was refused.

Link copied to clipboard

A connection timed out as a result of not receiving an ACK for data sent. This can include a FIN packet that did not get ACK'd.

Link copied to clipboard

A connection attempt failed.

Link copied to clipboard

The host name could not be resolved.

Link copied to clipboard

The Internet connection has been lost.

Link copied to clipboard

An SSL protocol error occurred.

Link copied to clipboard

The IP address or port number is invalid (e.g., cannot connect to the IP address 0 or the port 0).

Link copied to clipboard

The IP address is unreachable. This usually means that there is no route to the specified host or network.

Link copied to clipboard

The server requested a client certificate for SSL client authentication.

Link copied to clipboard

A tunnel connection through the proxy could not be established.

Link copied to clipboard

The client and server don't support a common SSL protocol version or cipher suite.

Link copied to clipboard

The server requested a renegotiation (rehandshake).

Link copied to clipboard

The proxy requested authentication (for tunnel establishment) with an unsupported method.

Link copied to clipboard

The SSL handshake failed because of a bad or missing client certificate.

Link copied to clipboard

A connection attempt timed out.

Link copied to clipboard

There are too many pending DNS resolves, so a request in the queue was aborted.

Link copied to clipboard

Failed establishing a connection to the SOCKS proxy server for a target host.

Link copied to clipboard

The SOCKS proxy server failed establishing connection to the target host because that host is unreachable.

Link copied to clipboard

The request to negotiate an alternate protocol failed.

Link copied to clipboard

The peer sent an SSL no_renegotiation alert message.

Link copied to clipboard

Winsock sometimes reports more data written than passed. This can be due to a broken LSP.

Link copied to clipboard

An SSL peer sent us a fatal decompression_failure alert. This typically occurs when a peer selects DEFLATE compression in the mistaken belief that it supports it.

Link copied to clipboard

An SSL peer sent us a fatal bad_record_mac alert. This has been observed from servers with buggy DEFLATE support.

Link copied to clipboard

The proxy requested authentication for tunnel establishment.

Link copied to clipboard

A failure to create a connection to the proxy server.

Link copied to clipboard

A mandatory proxy configuration could not be used. Currently, this means that a mandatory PAC script could not be fetched, parsed or executed.

Link copied to clipboard

The max socket limit for the socket pool has been hit while pre-connecting. The library doesn't bother trying to pre-connect more sockets.

The permission to use the SSL client certificate's private key was denied.

Link copied to clipboard

The SSL client certificate has no private key.

Link copied to clipboard

The certificate presented by the HTTPS Proxy was invalid.

Link copied to clipboard

An error occurred when trying to do a name resolution (DNS).

Link copied to clipboard

Permission to access the network was denied. This is used to distinguish errors that were most likely caused by a firewall from other access denied errors.

Link copied to clipboard

The request throttler module cancelled this request to avoid DDOS.

Link copied to clipboard

We were unable to sign the CertificateVerify data of an SSL client auth handshake with the client certificate's private key.

Link copied to clipboard

The message was too large for the transport. For example, a UDP message which exceeds size threshold.

Link copied to clipboard

Websocket protocol error. Indicates that we are terminating the connection due to a malformed frame or other protocol violation.

Link copied to clipboard

Returned when attempting to bind an address that is already in use.

Link copied to clipboard

The certificate didn't match the built-in public key pins for the host name.

Link copied to clipboard

Server request for client certificate did not contain any types we support.

Link copied to clipboard

An SSL peer sent us a fatal decrypt_error alert. This typically occurs when a peer could not correctly verify a signature (in CertificateVerify or ServerKeyExchange) or validate a Finished message.

Link copied to clipboard

There are too many pending WebSocketJob instances, so the new job was not pushed to the queue.

Link copied to clipboard

The SSL server certificate changed in a renegotiation.

Link copied to clipboard

The SSL server sent us a fatal unrecognized_name alert.

Link copied to clipboard

Failed to set the socket's receive buffer size as requested.

Link copied to clipboard

Failed to set the socket's send buffer size as requested.

Link copied to clipboard

Failed to set the socket's receive buffer size as requested, despite success return code from setsockopt.

Link copied to clipboard

Failed to set the socket's send buffer size as requested, despite success return code from setsockopt.

Link copied to clipboard

Failed to import a client certificate from the platform store into the SSL library.

Link copied to clipboard

Resolving a hostname to an IP address list included the IPv4 address 127.0.53.53. This is a special IP address which ICANN has recommended to indicate there was a name collision, and alert admins to a potential problem.

Link copied to clipboard

The SSL server presented a certificate which could not be decoded. This is not a certificate error code as no X509Certificate object is available. This error is fatal.

Link copied to clipboard

Certificate Transparency: Received a signed tree head that failed to parse.

Link copied to clipboard

Certificate Transparency: Received a signed tree head whose JSON parsing was OK but was missing some of the fields.

The attempt to reuse a connection to send proxy auth credentials failed before the AuthController was used to generate credentials. The caller should reuse the controller with a new connection. This error is only used internally by the network stack.

Link copied to clipboard

Certificate Transparency: Failed to parse the received consistency proof.

Link copied to clipboard

The SSL server required an unsupported cipher suite that has since been removed. This error will temporarily be signaled on a fallback for one or two releases immediately following a cipher suite's removal, after which the fallback will be removed.

Link copied to clipboard

When a WebSocket handshake is done successfully and the connection has been upgraded, the URLRequest is cancelled with this error code.

Link copied to clipboard

Socket ReadIfReady support is not implemented. This error should not be user visible, because the normal Read method is used as a fallback.

Link copied to clipboard

No socket buffer space is available.

Link copied to clipboard

There were no common signature algorithms between our client certificate private key and the server's preferences.

Link copied to clipboard

TLS 1.3 early data was rejected by the server. This will be received before any data is returned from the socket. The request should be retried with early data disabled.

Link copied to clipboard

TLS 1.3 early data was offered, but the server responded with TLS 1.2 or earlier. This is an internal error code to account for a backwards-compatibility issue with early data and TLS 1.2. It will be received before any data is returned from the socket. The request should be retried with early data disabled.

Link copied to clipboard

TLS 1.3 was enabled, but a lower version was negotiated and the server returned a value indicating it supported TLS 1.3. This is part of a security check in TLS 1.3, but it may also indicate the user is behind a buggy TLS-terminating proxy which implemented TLS 1.2 incorrectly.

Link copied to clipboard

The server's certificate has a keyUsage extension incompatible with the negotiated TLS key exchange method.

Link copied to clipboard

The server responded with a certificate whose common name did not match the host name. This could mean:

Link copied to clipboard

The server responded with a certificate that, by our clock, appears to either not yet be valid or to have expired. This could mean:

Link copied to clipboard

The server responded with a certificate that is signed by an authority we don't trust. This could mean:

Link copied to clipboard

The server responded with a certificate that contains errors. This error is not recoverable.

Link copied to clipboard

The certificate has no mechanism for determining if it is revoked. In effect, this certificate cannot be revoked.

Link copied to clipboard

Revocation information for the security certificate for this site is not available. This could mean:

Link copied to clipboard

The server responded with a certificate that has been revoked.

Link copied to clipboard

The server responded with a certificate that is invalid. This error is not recoverable.

Link copied to clipboard

The server responded with a certificate that is signed using a weak signature algorithm.

Link copied to clipboard

The host name specified in the certificate is not unique.

Link copied to clipboard

The server responded with a certificate that contains a weak key (e.g. a too-small RSA key).

Link copied to clipboard

The certificate claimed DNS names that are in violation of name constraints.

Link copied to clipboard

The certificate's validity period is too long.

Link copied to clipboard

Certificate Transparency was required for this connection, but the server did not provide CT information that complied with the policy.

Link copied to clipboard

The value immediately past the last certificate error code.

Link copied to clipboard

The URL is invalid.

Link copied to clipboard

The scheme of the URL is disallowed.

Link copied to clipboard

The scheme of the URL is unknown.

Link copied to clipboard

Attempting to load a URL resulted in a redirect to an invalid URL.

Link copied to clipboard

Attempting to load a URL resulted in too many redirects.

Link copied to clipboard

Attempting to load a URL resulted in an unsafe redirect (e.g., a redirect to file:// is considered unsafe).

Link copied to clipboard

Attempting to load a URL with an unsafe port number. These are port numbers that correspond to services, which are not robust to spurious input that may be constructed as a result of an allowed web construct (e.g., HTTP looks a lot like SMTP, so form submission to port 25 is denied).

Link copied to clipboard

The server's response was invalid.

Link copied to clipboard

Error in chunked transfer encoding.

Link copied to clipboard

The server did not support the request method.

Link copied to clipboard

The response was 407 (Proxy Authentication Required), yet we did not send the request to a proxy.

Link copied to clipboard

The server closed the connection without sending any data.

Link copied to clipboard

The headers section of the response is too large.

Link copied to clipboard

The evaluation of the PAC script failed.

Link copied to clipboard

The response was 416 (Requested range not satisfiable) and the server cannot satisfy the range requested.

Link copied to clipboard

The identity used for authentication is invalid.

Link copied to clipboard

Content decoding of the response body failed.

Link copied to clipboard

An operation could not be completed because all network IO is suspended.

Link copied to clipboard

There are no supported proxies in the provided list.

Link copied to clipboard

There is an HTTP/2 protocol error.

Link copied to clipboard

Credentials could not be established during HTTP Authentication.

Link copied to clipboard

An HTTP Authentication scheme was tried which is not supported on this machine.

Link copied to clipboard

Detecting the encoding of the response failed.

Link copied to clipboard

No Kerberos credentials were available during HTTP Authentication.

Link copied to clipboard

An unexpected, but documented, SSPI or GSSAPI status code was returned.

Link copied to clipboard

The environment was not set up correctly for authentication (for example, no KDC could be found or the principal is unknown).

Link copied to clipboard

An undocumented SSPI or GSSAPI status code was returned.

Link copied to clipboard

The HTTP response was too big to drain.

Link copied to clipboard

The HTTP response contained multiple distinct Content-Length headers.

Link copied to clipboard

HTTP/2 headers have been received, but not all of them — status or version headers are missing, so we're expecting additional frames to complete them.

Link copied to clipboard

No PAC URL configuration could be retrieved from DHCP. This can indicate either a failure to retrieve the DHCP configuration, or that there was no PAC URL configured in DHCP.

The HTTP response contained multiple Content-Disposition headers.

Link copied to clipboard

The HTTP response contained multiple Location headers.

Link copied to clipboard

HTTP/2 server refused the request without processing, and sent either a GOAWAY frame with error code NO_ERROR and Last-Stream-ID lower than the stream id corresponding to the request indicating that this request has not been processed yet, or a RST_STREAM frame with error code REFUSED_STREAM.

Link copied to clipboard

HTTP/2 server didn't respond to the PING message.

Link copied to clipboard

The HTTP response body transferred fewer bytes than were advertised by the Content-Length header when the connection is closed.

Link copied to clipboard

The HTTP response body is transferred with Chunked-Encoding, but the terminating zero-length chunk was never sent when the connection is closed.

Link copied to clipboard

There is a QUIC protocol error.

Link copied to clipboard

The HTTP headers were truncated by an EOF.

Link copied to clipboard

The QUIC crypto handshake failed. This means that the server was unable to read any requests sent, so they may be resent.

Link copied to clipboard

Transport security is inadequate for the HTTP/2 version.

Link copied to clipboard

The peer violated HTTP/2 flow control.

Link copied to clipboard

The peer sent an improperly sized HTTP/2 frame.

Link copied to clipboard

Decoding or encoding of compressed HTTP/2 headers failed.

Link copied to clipboard

Proxy authentication requested without a valid client socket handle.

Link copied to clipboard

HTTP_1_1_REQUIRED error code received on HTTP/2 session.

Link copied to clipboard

HTTP_1_1_REQUIRED error code received on HTTP/2 session to proxy.

Link copied to clipboard

The PAC script terminated fatally and must be reloaded.

Link copied to clipboard

The server was expected to return an HTTP/1.x response, but did not. Rather than treat it as HTTP/0.9, this error is returned.

Link copied to clipboard

Initializing content decoding failed.

Link copied to clipboard

Received HTTP/2 RST_STREAM frame with NO_ERROR error code. This error should be handled internally by HTTP/2 code, and should not make it above the SpdyStream layer.

Link copied to clipboard

An HTTP transaction was retried too many times due for authentication or invalid certificates. This may be due to a bug in the net stack that would otherwise infinite loop, or if the server or proxy continually requests fresh credentials or presents a fresh invalid certificate.

Link copied to clipboard

Received an HTTP/2 frame on a closed stream.

Link copied to clipboard

The server returned a non-2xx HTTP response code.

Link copied to clipboard

The certificate presented on a QUIC connection does not chain to a known root and the origin connected to is not on a list of domains where unknown roots are allowed.

Link copied to clipboard

The cache does not have the requested entry.

Link copied to clipboard

Unable to read from the disk cache.

Link copied to clipboard

Unable to write to the disk cache.

Link copied to clipboard

The operation is not supported for this entry.

Link copied to clipboard

The disk cache is unable to open this entry.

Link copied to clipboard

The disk cache is unable to create this entry.

Link copied to clipboard

Multiple transactions are racing to create disk cache entries. This is an internal error returned from the HttpCache to the HttpCacheTransaction that tells the transaction to restart the entry-creation logic because the state of the cache has changed.

Link copied to clipboard

The cache was unable to read a checksum record on an entry. This can be returned from attempts to read from the cache. It is an internal error, returned by the SimpleCache backend, but not by any URLRequest methods or members.

Link copied to clipboard

The cache found an entry with an invalid checksum. This can be returned from attempts to read from the cache. It is an internal error, returned by the SimpleCache backend, but not by any URLRequest methods or members.

Link copied to clipboard

Internal error code for the HTTP cache. The cache lock timeout has fired.

Link copied to clipboard

Received a challenge after the transaction has read some data, and the credentials aren't available. There isn't a way to get them at that point.

Link copied to clipboard

Internal not-quite error code for the HTTP cache. In-memory hints suggest that the cache entry would not have been usable with the transaction's current configuration, e.g. load flags, mode, etc.

Link copied to clipboard

The disk cache is unable to doom this entry.

Link copied to clipboard

The disk cache is unable to open or create this entry.

Link copied to clipboard

The server's response was insecure, e.g. there was a cert error.

Link copied to clipboard

An attempt to import a client certificate failed, as the user's key database lacked a corresponding private key.

Link copied to clipboard

An error adding a certificate to the OS certificate database.

Link copied to clipboard

An error occurred while handling a signed exchange.

Link copied to clipboard

An error occurred while handling a Web Bundle source.

Link copied to clipboard

A Trust Tokens protocol operation-executing request failed for one of a number of reasons (precondition failure, internal error, bad response).

Link copied to clipboard

When handling a Trust Tokens protocol operation-executing request, the system found that the request's desired Trust Tokens results were already present in a local cache; as a result, the main request was cancelled.

Link copied to clipboard

PKCS #12 import failed due to incorrect password.

Link copied to clipboard

PKCS #12 import failed due to other error.

Link copied to clipboard

CA import failed - not a CA cert.

Link copied to clipboard

Import failed, a certificate already exists in database.

Link copied to clipboard

CA import failed due to some other error.

Link copied to clipboard

Server certificate import failed due to some internal error.

Link copied to clipboard

PKCS #12 import failed due to invalid MAC.

Link copied to clipboard

PKCS #12 import failed due to invalid/corrupt file.

Link copied to clipboard

PKCS #12 import failed due to unsupported features.

Link copied to clipboard

Key generation failed.

Link copied to clipboard

Failure to export private key.

Link copied to clipboard

Self-signed certificate generation failed.

Link copied to clipboard

The certificate database changed in some way.

Link copied to clipboard

DNS resolver received a malformed response.

Link copied to clipboard

DNS server requires TCP.

Link copied to clipboard

DNS server failed. This error is returned for all the following error conditions:

Link copied to clipboard

DNS transaction timed out.

Link copied to clipboard

The entry was not found in cache or other local sources, for lookups where only local sources were queried.

Link copied to clipboard

Suffix search list rules prevent resolution of the given host name.

Link copied to clipboard

Failed to sort addresses according to RFC3484.

Functions

Link copied to clipboard
open fun valueOf(name: String): NetError

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Link copied to clipboard
open fun values(): Array<NetError>

Returns an array containing the constants of this enum type, in the order they're declared. This method may be used to iterate over the constants.